Overview
ElevateAI APIs leverage cutting-edge research in artificial intelligence (AI), automatic speech recognition (ASR), and natural language processing (NLP) to transcribe audio conversations into precise text that can be fed into any data lake or application.
Using ElevateAI, you can access key data needed to understand conversations at scale. CX AI provides objective insights into audio, transcription, and chat interactions, such as voice activity, out-of-the-box CX behavioral models – including sentiment analysis – and the Generative AI-powered AutoSummary and Agent Improvement suite.
Our latest model Echo supports over 50+langauges at unparalleled accuracy. Check out Echo Model Supported Languages for the full list!
Getting started takes less than 60 seconds. For each of the API endpoints, you will find a tutorial outlining required parameters, code samples, and response examples / schemas.
You can transcribe and analyze audio interactions directly from the web-based ElevateAI portal, with no code needed.
We're here to help!
If you have any questions, our team of product experts and developers are available and eager to provide additional support!
Your active API tokens authorize requests on behalf of your account and carry many privileges, so be sure to keep them secure. Do not share your API tokens in publicly accessible areas such as GitHub, client-side code, etc.
To ensure authentication, all API requests must be made over HTTPS. Requests made over plain HTTP and/or API requests without an active API token will fail.
For your convenience and security, API tokens can be managed at any time in the Manage Tokens Dashboard.
Your data is yours!
The ElevateAI API is secured with Transport Layer Security (TLS) 1.2 to secure and encrypt the communication as well as protect the data in transit. The Service also uses TLS mutual authentication to ensure only legitimate users can access the API.
All source data is deleted promptly upon processing. Analysis output is stored in our US-based data warehouse for up to 45 days, encrypted in transit and at rest, so that you may access your results. After 45 days, all associated data is deleted and irretrievable.
If you have retrieved the desired results and would like to permanently delete all analysis data from our database prior to the 45-day standard retention period, you may do so at any time using the DELETE API endpoint.
As a publicly traded company trusted by leading brands worldwide, we make data security a top priority. See additional information in the ElevateAI Privacy Notice.
Remember: You can retrieve the processing status of your interaction at any time directly from a GET API endpoint or the Interactions Dashboard.
Audio interaction are generally processed within 25-65% of the total file duration, but may vary by system integration and number of concurrent requests.
Transcript and chat interactions are generally processed in seconds, but may vary by system integration and number of concurrent requests.
ElevateAI supports virtually all unencrypted audio types, whether single or dual channel. If you have any questions or would like to see a full list of supported audio files, reach out to us at [email protected].
Pro Tip: For highest levels of accuracy, we suggest stereo G.729A audio files.
ElevateAI supports both uploads and downloads up to 450MB.
Echo supports 50+ languages. See Echo Model Supported Languages for details.
Echo is ideal for all media types - Interviews, podcasts, videos, calls, Contact-Center media etc.
Our CX model is ideal for Contact-Center media
| Language Tag | PII Redaction |
|---|---|---|
North American English | en-us | social security numbers, credit card numbers, and cvv numbers |
International English | en | credit card numbers, and cvv numbers |
Latin American Spanish | es-419 | social security numbers, credit card numbers, and cvv numbers |
French | fr | |
German | de | |
Brazilian Portuguese | pt-br | |
Japanese | ja | |
Cantonese | zh-YUE | |
Mandarin | zh-CMN | |
Languages Supported by our custom CX AI Models. Our CX AI models generate reportable AI scores for useful contact center metrics. See CX AI Features
| Language Tag | CX AI Models |
|---|---|---|
North American English | en-us | Behaviors for CSAT, Sales Effectiveness |
International English | en | |
Latin American Spanish | es-419 | |
Brazilian Portuguese | pt-br |
Our Generative AI end points support all Echo Model Supported Languages
Generative AI endpoints can be called in real-time - Declare --> immediately call Generative AI for chats and transcripts. Audio files require processing to be completed.
ElevateAI uses conventional HTTP response codes for each API request. Codes in the 2xx range indicate the request successfully executed. Codes in the 4xx range indicate a failure based on the information provided (e.g., a required parameter was omitted). While rare, codes in the 5xx range may indicate an error with the ElevateAI service.
If a request is successful but an error occurs when uploading, downloading, or processing your interaction, a descriptive errorMessage will be provided when checking the processing status of the interaction.
We're here to help!
If you have any questions not addressed within this documentation, our team of product experts and developers are available and eager to provide additional support!
HTTP Status Code | Summary |
|---|---|
400 - Bad Request | The API request does not contain the expected parameters (either missing a required parameter or providing an unexpected value for a parameter). Prior to re-requesting, review the parameters and code examples within the associated tutorial. |
401 - Unauthorized | The API request is missing or passed an invalid X-API-Token in the header. Prior to re-requesting, confirm or request your API token within the Manage Tokens Dashboard. |
404 - Not Found | Either the API request was made with an invalid/deleted interactionIdentifer in the path, or analysis results have been requested prior to processing completion. Prior to re-requesting, confirm your API token within the Manage Tokens Dashboard, check the processing status. |
409 - Conflict | The API request made can't be complete because you have previously uploaded an audio file or provided a downloadUri when declaring the audio interaction. |
413 - Payload Too Large | The ElevateAI service couldn't retrieve the uploaded file or the file is larger than the maximum supported file size. Confirm file size, re-upload, and if you still receive the error, re-declare the interaction. |
429 - Too Many Requests | The API request to declare the interaction exceeds the monthly quota associated with your account. To upgrade to a paid account or request your quota be increased, contact us at [email protected]. |
Free accounts have access to declare up to 1,000 interactions per day! If you are interested in upgrading to a paid account for higher usage, please contact us at [email protected].
By default, paid accounts have access to declare up to 5,000 interactions per day.
If you require a higher limit, pleased reach out to us at [email protected] to request this limit be increased.
Our team of product experts and developers are on call and available to answer any questions you may have!
For the fastest response times, please direct your question to the following:
Questions about upgrading to a paid account? contact us at... | |
|---|---|
Questions about the terms of use, privacy policy, or the legal things? contact us at... | |
Questions about our product roadmap or to request a feature? contact us at... | |
For ANY OTHER support questions, contact us at... |